---
title: "Gap"
description: "Utilities for controlling gutters between grid and flexbox items."
---

import plugin from 'tailwindcss/lib/plugins/gap'
import { Variants } from '@/components/Variants'
import { Disabling } from '@/components/Disabling'
import { numbersFirst } from '@/utils/sortClasses'

export const classes = {
  plugin,
  sort: numbersFirst,
}

## Usage

Use `gap-{size}` to change the gap between both rows and columns in grid and flexbox layouts.

```html indigo
<template preview class="p-6">
  <div>
    <div class="grid grid-cols-2 gap-4">
      <div class="h-16 rounded-md text-center bg-indigo-500"></div>
      <div class="h-16 rounded-md text-center bg-indigo-500"></div>
      <div class="h-16 rounded-md text-center bg-indigo-500"></div>
      <div class="h-16 rounded-md text-center bg-indigo-500"></div>
    </div>
  </div>
</template>

<div class="grid **gap-4** grid-cols-2">
  <div>1</div>
  <div>2</div>
  <div>3</div>
  <div>4</div>
</div>
```

### Changing row and column gaps independently

Use `gap-x-{size}` and `gap-y-{size}` to change the gap between rows and columns independently.

```html rose
<template preview class="p-6">
  <div>
    <div class="grid grid-cols-3 gap-x-8 gap-y-4">
      <div class="h-16 rounded-md text-center bg-rose-500"></div>
      <div class="h-16 rounded-md text-center bg-rose-500"></div>
      <div class="h-16 rounded-md text-center bg-rose-500"></div>
      <div class="h-16 rounded-md text-center bg-rose-500"></div>
      <div class="h-16 rounded-md text-center bg-rose-500"></div>
      <div class="h-16 rounded-md text-center bg-rose-500"></div>
    </div>
  </div>
</template>

<div class="grid **gap-x-8** **gap-y-4** grid-cols-3">
  <div>1</div>
  <div>2</div>
  <div>3</div>
  <div>4</div>
  <div>5</div>
  <div>6</div>
</div>
```

---

## Responsive

To control the gap at a specific breakpoint, add a `{screen}:` prefix to any existing gap utility. For example, use `md:gap-6` to apply the `gap-6` utility at only medium screen sizes and above.

```html
<div class="grid gap-4 **md:gap-6** ...">
  <!-- ... -->
</div>
```

For more information about Tailwind's responsive design features, check out the [Responsive Design](/docs/responsive-design) documentation.

---

## Customizing

By default, Tailwind's gap scale matches your configured [spacing scale](/docs/customizing-spacing).

You can customize the global spacing scale in the `theme.spacing` or `theme.extend.spacing` sections of your `tailwind.config.js` file:

```diff-js
  // tailwind.config.js
  module.exports = {
    theme: {
      extend: {
        spacing: {
+         '72': '18rem',
+         '84': '21rem',
+         '96': '24rem',
        }
      }
    }
  }
```

To customize the gap scale separately, use the `gap` section of your Tailwind theme config.

```diff-js
  // tailwind.config.js
  module.exports = {
    theme: {
      extend: {
        gap: {
+         '11': '2.75rem',
+         '13': '3.25rem',
        }
      }
    }
  }
```

Learn more about customizing the default theme in the [theme customization documentation](/docs/theme#customizing-the-default-theme).

### Variants

<Variants plugin="gap" />

### Disabling

<Disabling plugin="gap" />
